FileLoggingSession Sample


Windows Runtime
Diagnostics, file logging
Windows RT
en-US
11/25/2013

This sample shows how to log messages and data to a file continuously as your app runs. You can view the log files by using the Windows Performance Toolkit (WPT) and other utilities like tracerpt.exe.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Microsoft Visual Studio 2013, go to Visual Studio 2013.

Note  For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.

The sample demonstrates these tasks:

  1. Send messages and data to a log file

    Uses the LogMessage and LogValuePair methods to send messages and data to a FileLoggingSession.

  2. Log file has reached the maximum size

    Handles the LogFileGenerated event, which indicates when a log file has reached the maximum size and is ready for analysis.

  3. Move a logging session file to an app's log repository folder

    Uses the LocalFolder property and the MoveAsync method to move a log file to the app's log repository folder.

  4. Manage generated logs in an app's log repository folder

    Queries for log files and generates names for new log files.

  5. Track logging state during suspend and resume

    Handles the Suspending and Resuming events and enables logging accordingly.

Related topics

Windows.Foundation.Diagnostics
Windows 8 app samples

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2

Build the sample

  1. Start Visual Studio 2013 and select File > Open > Project/Solution.
  2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Visual Studio 2013 Solution (.sln) file.
  3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.